Saisir dans (Type Into)

UiPath.UIAutomationNext.Activities.NTypeInto

Description

Entre du texte dans un élément d'IU spécifié, par exemple une zone de texte.

Vous pouvez également envoyer des touches spéciales comme Tab ou Entrée dans l'élément d'IU.

Les touches permanentes sont également prises en charge. Par exemple, si vous souhaitez saisir Shift+End pour sélectionner uniquement une partie du texte d'une commande, vous devez sélectionner Shift et End dans la liste des touches spéciales, et le texte proposé est [k(Shift)][k(End)]. Cela émule les touches Shift et End enfoncées de manière séquentielle. Le texte correct est [d(Shift)][k(End)][u(Shift)], où d représente la touche baissée, k représente la touche enfoncée et u représente la touche levée.

Si vous souhaitez saisir des informations sensibles en toute sécurité, ajoutez une activité Récupérer le nom d'utilisateur/mot de passe (Get Username/Password) avant cette activité et sélectionnez comme texte à saisir les valeurs d'utilisateur et de mot de passe enregistrées de cette activité pour une utilisation ultérieure

Cette activité ne peut pas être ajoutée dans une activité Use Application/Browser.

Cette activité est compatible avec le référentiel d’objets.

Pour apprendre à utiliser cette activité, consultez :

• Tutoriel : travailler avec l’UI Automation.
• Tutoriel : remplir des formulaires en format PDF avec des données Excel dans Acrobat Reader.

Conditions préalables à la saisie sécurisée des informations de connexion

Avant de pouvoir saisir les informations de nom d'utilisateur/mot de passe en toute sécurité à l'aide de cette activité, vous devez d'abord :

1. Ajoutez une activité Obtenir le nom d'utilisateur/mot de passe (Get Username/Password ) au projet.
2. Dans l’activité Obtenir le nom d’utilisateur/mot de passe (Get Username/Password ), sélectionnez les informations d’identification précédemment enregistrées dans le Gestionnaire d’informations d’identification Windows. Si les informations d'identification que vous souhaitez utiliser ne sont pas déjà enregistrées dans le Gestionnaire d'informations d'identification Windows, vous pouvez utiliser cette activité pour les ajouter.
3. Enregistrez les informations d'identification pour une utilisation ultérieure dans le projet.

Compatibilité du projet

Windows - Héritage | Windows | Multiplateforme

Windows - Héritage, configuration Windows

Module Designer

• Cliquez sur Indiquer dans l'application/le navigateur (Indicate in App/Browser) pour indiquer l'élément d'IU à utiliser comme cible.

  Cette étape n'est pas requise si l'élément est déjà actif dans l'application cible.

  Après avoir indiqué la cible, sélectionnez le menu pour accéder aux options suivantes :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.
  • Ajouter une vérification automatique (Add auto-verification ) : permet de vérifier si les Actions effectuées par l'activité étaient correctes.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

• Saisir ceci (Type this ) - Texte à saisir. Vous pouvez utiliser le menu déroulant pour sélectionner une touche spéciale à envoyer au champ de texte ou vous pouvez ajouter des touches spéciales à partir du générateur de texte. Vous pouvez également utiliser les options du menu Plus dans le générateur de texte pour ajouter des valeurs enregistrées pour plus tard ou ajouter des données à partir du Bloc-notes du projet ou des activités parentes Utiliser un fichier Excel ou Utiliser un compte Outlook . Toute combinaison de texte, de données Excel ou Outlook et de touches spéciales est prise en charge.

• Champ vide avant de taper (Vide field before typing ) : indiquez si vous souhaitez supprimer le contenu existant dans le champ avant de saisir le texte, et indiquez comment vider le champ. Les champs sont vidés en envoyant une combinaison de frappes qui diffère entre les champs avec une seule ligne et les champs avec plusieurs lignes. Assurez-vous de sélectionner la bonne option en fonction du champ indiqué. Les options sont les suivantes :
  • Aucun (None ) : ne supprime pas le contenu existant.
  • Une seule ligne (End, Shift+Home, Del) - Supprime le contenu d'un champ de texte avec une seule ligne. Il s'agit de l'option par défaut.

  • Multiligne (Ctrl+A, Suppr) : permet de supprimer le contenu d'un champ de texte comportant plusieurs lignes.

  Pour utiliser l'activité afin d'effacer le champ de texte indiqué, configurez cette propriété pour supprimer le contenu existant, laissez le champ Type this vide (Type this field) et définissez la propriété Mode d'entrée ( Input Mode ) sur Événements matériels ( Hardware Events).

• Cliquer avant de taper (Click before typing ) : indiquez si vous souhaitez cliquer sur l'élément d'IU spécifié avant de saisir le texte, et indiquez le type de clic à effectuer. Les options sont None (ne pas cliquer), Single (exécuter un simple clic) ou Double (exécuter un double clic).

  L'option par défaut est Single(Single).

• Vérifier que le texte est vide (Verify that the text is empty ) - Cette option s'affiche si l'option Ajouter une vérification automatique (Add auto-verification ) est sélectionnée. Vous pouvez l’indiquer dans l’application actuelle ou dans n’importe quelle application.

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

• Délai après : délai (en secondes) entre le moment où cette activité est terminée et le moment où l'activité suivante commence toutes les opérations. La valeur par défaut est de 0,3 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

Entrée

• Texte sécurisé (Secure text ) : le texte sécurisé à saisir. Le champ ne prend en charge que les variables SecureString. Si ce champ est configuré, le champ Texte est effacé. La longueur de chaîne maximale pour ce champ est de 65536 caractères.
• Cible (Target) - L'élément cible. L’élément cible doit être défini. Avant d'être indiqué à l'écran, ce champ est défini sur (null). Une fois la cible indiquée, toutes les propriétés concernant l'élément qui a été indiqué sont affichées.
  • Décalage duclic : spécifie un décalage pour l'activité de clic, qui peut être configuré davantage.
    • Point d'ancrage - Décrit le point de départ du curseur auquel les décalages des propriétés Décalage X et Décalage Y sont ajoutés. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRightet Center. Par défaut, Center est sélectionné.
    • Décalage X - Déplacement horizontal de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32 .
    • Décalage Y - Déplacement vertical de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32 .
  • Type decontrôle CV (CV Control type ) : indique le type de contrôle identifié à l'aide de Computer Vision.
  • Texte CV - Indique le texte identifié à l’aide de Computer Vision.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • Texte natif : le texte utilisé pour identifier l'élément d'IU.
  • Sites Web réactifs - Activez la mise en page des sites Web réactifs.
  • Sélecteur strict : le sélecteur strict généré pour l'élément d'IU.
  • Méthodes de ciblage : les types de sélecteurs à utiliser pour identifier l'élément. Cette propriété peut recevoir n'importe quelle combinaison à partir du menu déroulant :
    • Aucun (None)
    • Sélecteur strict
    • Sélecteur de correspondances approximatives
    • Image
    • Texte natif
    • Computer Vision
  • Contrôle de visibilité (Visibility check ) - Vérifie si l'élément d'IU est visible ou non. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • Aucun : ne vérifie pas la visibilité.
    • Interactif (pour le Sélecteur de correspondances approximatives) : option par défaut. Vérifie si l'élément est potentiellement visible, en ignorant le défilement de la page et les obstructions par d'autres applications, ou le fait que l'application est réduite. Cette vérification est utile lorsque vous essayez de vous assurer que vous ne ciblez pas des éléments invisibles qui existent dans le DOM mais qui sont masqués.
    • Entièrement visible : vérifie si l'élément d'IU est visible ou non.
  • Attendre le chargement de la page : avant d'effectuer les Actions, attendez que l'application soit prête à accepter les entrées. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • None : n’attend pas que la cible soit prête.
    • Interactif : attend qu'une partie de l'application soit prête.
    • Complète  : attend que l'application entière soit prête.
  • Sélecteur de fenêtre (Instance d'application) : le sélecteur utilisé pour la fenêtre d'application. Uniquement applicable lorsque le mode d'attachement de fenêtre est défini sur Instance d'application (Application instance).
• Texte : le texte à saisir. Vous pouvez ajouter des clés spéciales au texte à partir de la liste déroulante dans le corps de l'activité. Si ce champ est configuré, le champ de texte Sécurisé est effacé. La longueur de chaîne maximale pour ce champ est de 65536 caractères.

• Vérifier l'exécution : lors de l' Runtime, vérifie si les Actions effectuées par l'activité étaient correctes. Cela se fait soit en vérifiant si le texte spécifié dans la propriété Texte attendu se trouve dans l'élément de l'interface utilisateur indiqué après l'exécution de l'activité, ou en indiquant un élément qui doit apparaître ou disparaître après l'exécution des Actions , qui est surveillé et vérifié après l'activité est exécutée. Cette fonctionnalité peut être activée à partir des paramètres du projetou du corps de l'activité, en sélectionnant Ajouter une vérification automatique (Add Auto-Verification ) dans le menu contextuel.

  • Nom affiché (Display name ) : le nom affiché des Actionsde vérification. Ce champ est rempli automatiquement en fonction des Actions de vérification et de l'élément que vous avez choisis. Une fois la vérification de l'exécution configurée, ce nom d'affichage devient visible dans la carte d'activité.
  • Texte attendu (Expected text ) - Texte censé être saisi dans le champ de texte spécifié. Ce champ est facultatif. Ce champ ne prend en charge que les chaînes et les variables String .
  • Réessayer (Retry) - Lorsque cette option est sélectionnée, les Actions sont réessayées pendant toute la durée du délai d’attente de l’activité, si les résultats attendus n’ont pas été atteints. Par défaut, cette case est cochée.
  • Cible : cette cible est utilisée pour indiquer l'élément que vous souhaitez vérifier au moment du Runtime. Pour plus d'informations sur les champs de propriété qui peuvent être développés sous cette propriété, consultez la propriété Cible ci-dessus, car la fonctionnalité des propriétés est la même.
  • Délai d'attente : durée (en secondes) d'attente de l'apparition, de la disparition ou de la modification de l'élément à vérifier. Si la case Réessayer (Retry) est cochée, les Actions sont exécutées à nouveau, suivies de la vérification, et pour la durée spécifiée dans la propriété Délai d'attente ( Timeout ) de l'activité. La valeur par défaut est 10 secondes.
  • Vérifier l'élément : définit la modification pour laquelle vous souhaitez vérifier la cible de vérification. Les options disponibles sont :
    • Apparu : Vérifie si l'élément apparaît.
    • Disparu : vérifie si l'élément disparaît.
    • Texte modifié (Text Changed ) - Vérifie s'il y a des changements dans le texte de l'élément.
    • Modifié visuellement (Visually Changed ) - Vérifie s'il y a des changements d'image de l'élément.

Élément d’entrée/de sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.

Divers

• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

Options

• Modifier l'élément désactivé : si cette option est sélectionnée, l'activité exécute les Actions même si l'élément d'IU spécifié est désactivé. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

  Cette propriété ne s’applique pas si la propriété Mode d’entrée est définie sur Événements matériels.

• Mode d'entrée (Input mode ) : sélectionnez la méthode que le Robot doit utiliser pour interagir avec l'application cible :

  • Identique à l'application/au navigateur (Identique à l'application/au navigateur ) - Utilisez le même mode d'entrée que l'activité Utiliser l'application/le navigateur .

    Il s'agit de la sélection par défaut.

  • Événements matériels (Hardware Events ) : utilise le pilote matériel pour effectuer l'action. C'est la méthode la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.

  • Simuler : simule à l'aide des API d'accessibilité. Recommandé pour les navigateurs, les applications basées sur Java, SAP. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

    Dans le panneau Propriétés (Properties), le en regard du champ de propriété Mode d'entrée (Input Mode) teste et sélectionne automatiquement le mode d'entrée adapté aux Actions que vous effectuez. À l’aide de cette fonctionnalité, le texte est saisi dans le champ cible avec toutes les méthodes d’entrée disponibles, et celle qui fonctionne le mieux est automatiquement choisie.

    Les propriétés Activer, Cliquer avant de taper, Délai entre les toucheset Champ vide ne peuvent pas être utilisées avec le mode de saisie Simuler.

  • ChromiumAPI - Effectue des actions grâce aux API de débogage. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l'application cible nest pas au point. Pour plus de détails, consultez cette page.

  • Messages de fenêtre : simulez l'utilisation de messages Win32. Recommandé pour les applications de bureau. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

Options - Événements matériels / API Chromium

• Activer (Activate) : place l'élément d'IU au premier plan et activez-le avant de cliquer dessus. Si n'est pas sélectionné, l'activité entre dans la fenêtre active actuelle. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est True.
• Cliquer avant de taper : voir Cliquer avant de taper dans le panneau Concepteur.
• Délai entre les touches : délai (en secondes) entre les frappes consécutives. La valeur par défaut est de 0,02 seconde. La valeur maximale est de 1 seconde.
• Champ vide : voir Champ vide avant de taper dans le panneau Concepteur.

Options – Simuler

• Désélectionner à la fin (Deselect at end ) : cette case à cocher ne peut être utilisée que lorsque la propriété Mode d'entrée ( Input Mode ) est définie sur Simuler (Simulate) et est sélectionnée par défaut. Certaines applications cibles n'enregistrent pas d'action de type à moins qu'un événement Complète ne soit également envoyé avec l'action. La sélection de cette case à cocher ajoute un événement Complet (Complet) après la saisie de texte, afin d'enregistrer correctement l'action. Si cette case est décochée, l'événement Complete n'est pas envoyé à l'application cible. Par défaut, cette case est cochée.

Configuration multiplateforme

• Étendue du travail (Work in scope ) - Choisissez l'onglet du navigateur générant le rendu de l'application Web à automatiser.

• Indiquer la cible à l’écran : indiquez l’élément d’IU à utiliser comme cible.

  Après avoir indiqué la cible, sélectionnez le bouton Plus pour accéder aux options suivantes :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.

• Saisir ceci (Type this ) - Texte à saisir. Vous pouvez ajouter des touches spéciales à partir du générateur de texte.

Options supplémentaires

Horaires

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai après : délai (en secondes) entre le moment où cette activité est terminée et le moment où l'activité suivante commence toutes les opérations. La valeur par défaut est de 0,3 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

Options

• Champ vide (Vide field) - indiquez si vous souhaitez supprimer le contenu existant dans le champ avant de saisir le texte, et indiquez comment vider le champ. Les champs sont vidés en envoyant une combinaison de frappes qui diffère entre les champs avec une seule ligne et les champs avec plusieurs lignes. Assurez-vous de sélectionner la bonne option en fonction du champ indiqué. Les options sont les suivantes :
  • Aucun (None ) : ne supprime pas le contenu existant.
  • Une seule ligne (End, Shift+Home, Del) - Supprime le contenu d'un champ de texte avec une seule ligne. Il s'agit de l'option par défaut.

  • Multiligne (Ctrl+A, Suppr) : permet de supprimer le contenu d'un champ de texte comportant plusieurs lignes.

• Cliquer avant de taper (Click before typing ) : indiquez si vous souhaitez cliquer sur l'élément d'IU spécifié avant de saisir le texte, et indiquez le type de clic à effectuer. Les options sont None (ne pas cliquer), Single (exécuter un simple clic) ou Double (exécuter un double clic). L'option par défaut est Single(Single).
• Activer : si cette option est sélectionnée, l'élément d'IU spécifié sera mis au premier plan et activé avant que le texte ne soit saisi. Si n'est pas sélectionné, l'activité entre dans la fenêtre active actuelle. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est True.
• Désélectionner à la fin (Deselect at end ) : ajoute un événement Terminer après la saisie du texte pour déclencher certaines réponses d'IU dans les navigateurs Web.

• Mode d'entrée (Input mode ) : sélectionnez la méthode que le Robot doit utiliser pour interagir avec l'application cible :

  • Identique au navigateur (Identique au navigateur) - Utilisateur, le paramètre Mode d'entrée de l'activité parente Utiliser le navigateur ( Use Browser ). Il s'agit de l'option par défaut.
  • ChromiumAPI - Effectue des actions grâce aux API Debugger. Fonctionne uniquement pour les éléments Chrome et Edge. Envoie tout le texte en une seule fois. Fonctionne même si l’application cible n’est pas au point.
  • Simuler : simule le clic à l'aide des API d'accessibilité. Fonctionne avec les navigateurs. Envoie tout le texte en une seule fois. Cette méthode d'entrée fonctionne en arrière-plan (même si l'application cible n'est pas au point).

Entrée/sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.